home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir24 / morse111.zip / MORSE.DOC < prev   
Text File  |  1994-07-28  |  10KB  |  209 lines
  1. Files included:
  2. morse.doc this file.
  3. morse.com executable morse program.
  4. morse.asm assembly source for morse.com.
  5. morse makefile for morse.com.
  6.  
  7. Morse.com is a TSR program which echoes screen output in morse code.
  8. If no arguments are given, morse will start at 16 words per minute at
  9. 1000HZ.  You can permanently change these default with the configure
  10. option described later.  Morse may also be started with command line
  11. arguments as follows:
  12. morse [c][s][H][frequency] [speed] [ratio] [weighting] [timing]
  13. Frequency can range from 20 to 10,000HZ.  Speed, weighting, and ratio
  14. ranges from 3 to 100 words per minute.
  15. weighting, Ratio and timing are described later.  If the letter S is the
  16. first character of the first argument, the Copyright message is skipped.
  17. a C as the first argument will run the configure part of morse.com.
  18. H will display a help message and then exit to dos.
  19. Morse can also be run so it outputs a message and exits without staying
  20. resident. If the first argument starts with a letter other than c, h, or s
  21. the following digit is taken to be the starting argument of the output.
  22. For example if you want to output a morse message at 25 words per minute
  23. at 400HZ use the syntax
  24. morse a3440 25 this is a morse message.
  25. The 3 indicates the actual message starts with the third argument.
  26.  
  27. After morse is started, every character printed on the screen is echoed
  28. in morse.  Output to the screen will be much slower because the
  29. character if first output in morse and then sent to the screen.  The
  30. following paragraphs describe the commands available in morse.
  31.  
  32. Pressing the ALT key during morse output tells morse to skip the current
  33. line.  Normal output resumes when you release the ALT key.   If CLICKS
  34. are on (see configuring morse later)  a click is sounded whenever a new
  35. line is encountered.
  36.  
  37. ALT-CTRL-D Removes morse.com from memory without rebooting.  I recommend
  38. this only be done while at the DOS prompt.  If an error occurs, you
  39. should reboot immediately.
  40.  
  41. <F1> You are prompted for speed in morse only.    Enter the desired speed
  42. and press <RETURN>
  43.  
  44. <F2>  You are prompted in morse to enter frequency.
  45.  
  46. <F3>  Toggles decimal mode.  When active "DEC" is output in morse.  In
  47. this mode, all characters are output in decimal.  For example A is
  48. output as 65.
  49.  
  50. <F4>  Toggles practice mode.  In practice mode, all characters are
  51. converted to uppercase and all punctuation marks except . / ? - are
  52. ignored.  If practice is off, lowercase characters are output at a lower
  53. frequency and control A-Z are output one octave below uppercase
  54. characters.  Also, nonstandard morse punctuation characters are output.
  55.  
  56. <F5>  Toggles hex mode.  When active "HEX" is output.  All characters are
  57. output in hex, "A" would be output as 41.
  58.  
  59. <F6>  Output entire cursor line.
  60.  
  61. <F7> Output current line from the cursor to the right.
  62.  
  63. <F8>  Output cursor position and character for example L3 C15 q is sent
  64. in morse indicating q is at line 3 column 15.
  65.  
  66. <F9> You are prompted in morse for a line A-Y.    The indicated line will
  67. be output in morse.  For example J would output line 10.
  68.  
  69. <F10> is used as the first key for the following commands:
  70. \  Toggles quiet mode.    When active the morse character ...-.- is
  71. output.  All further morse output is suspended until quiet mode is
  72. turned off.  This is done by pressing shift alt and ctrl, or another F10
  73. \..
  74.  
  75. F will sound a continuous tone.  Pressing CTRL raises frequency and ALT
  76. lowers frequency.  Press any key to stop tone.    The frequency is output
  77. in morse.
  78.  
  79. S  sweeps speed.  A series of dashes is sounded.  Increase
  80. speed with the CTRL key and decrease it with the ALT key.  Press any key
  81. to exit.  The speed in words per minute is output in morse.
  82.  
  83. K "TYPE" is output in morse.  Any character typed will be sent in morse
  84. but not echoed to the screen.  Press <ESC> to exit.
  85.  
  86. T Timing.  Morse attempts to determine your machine's clock speed using
  87. interrupt 1ch.    If the morse characters seem faster or slower than they
  88. should be for a given speed, you may adjust the timing.  To make the
  89. change in timing permanent, you can use the configure option. The faster
  90. your machine the higher the timing value you will need.  For example on a
  91. 20MHZ 80386 a value of 65 is appropriate. On a 33MHZ 80486 an approximate
  92. value of 170 should be used.
  93.  
  94. r sweep ratio (See ratio and weighting later)
  95.  
  96. w sweep weighting (See ratio and weighting later)
  97.  
  98. ? Find mode.  (See Find later)
  99.  
  100. INS "RVU" is output indicating review mode.  This is used to examine the
  101. screen.  Pressing <ESC> will exit back to your application.  The up down
  102. right and left cursor keys work as expected.  Home moves cursor to
  103. upperleft corner of the screen.  End moves cursor to the lower left.
  104. Pageup moves cursor vertically to the top of the screen.  Pagedown moves
  105. cursor vertically to the bottom of the screen.    CTRL-left moves to
  106. previous word.    CTRL-right moves to the next word.  Typing A through Y
  107. outputs that line.
  108. Tab and Shift-Tab moves the cursor to the next or previous tab position.
  109.  
  110. Find is used to search the screen for a given string.  Search is case
  111. insensitibe.  Enter the string to search for and press <RETURN>.
  112. The search begins at the cursor position.
  113.  
  114. Ratio and Weighting
  115. The ratio adjustment changes the speed of the dits compared to the dots.
  116. Normally this is set to the proper value every time speed is set.  It
  117. may be set to a different value if you want to simulate an unusual
  118. sending style.    Weighting specifies separation between dits and dots.
  119.  
  120. Cunfiguring morse.
  121. morse.com is divided into a resident portion and a transient portion.
  122. When morse becomes resident the transient portion is discarded.  The
  123. transient portion contains the greeting screen message and the code to
  124. initialize and install the resident part.  It also includes code to
  125. reconfigure the program.  Run morse c to start configuration.
  126. Sample configuration session:
  127. BLINDOS/PC
  128. Version 1.11
  129. Copyright 1990-1994 by Randy Formenti  N8KL
  130.  
  131. Morse configuration allows you to modify defaults
  132. for frequency, speed, weighting, ratio, timing, practice and clicks.
  133. The Morse default function keys and the morse translation table may also be
  134. modified.
  135. After configuration, MORSE may be run with these new defaults without command
  136. line arguments.
  137. Press <ESC> to abort or any other key to continue.
  138.  
  139. Enter frequency <20-10000> (Default is 1000) 
  140. Enter speed <3-100> (Default is 16) 
  141. Enter weighting <3-100> (Default is 16) 
  142. Enter ratio <3-100> (Default is 16) 
  143. Enter timing <0-32767> (Default is 0) 
  144. Do you want practice mode on <Y/N> (Default is NO) 
  145. Do you want clicks on? <Y/N> (Default is YES) 
  146. Choose from the following:
  147. 1 - F1 through F10
  148. 2 - CTRL F1 through CTRL F10
  149. 3 - SHIFT F1 through SHIFT F10
  150. 4 - ALT F1 through ALT F10
  151. Enter your choice: 1
  152. Do you want to modify the Morse translation table (Y/N)
  153.  
  154. If you have made changes you are asked if you want to write the new
  155. configuration back to disk.  If not, press <ESC> to abort and morse.com will
  156. not be changed.
  157. Morse.com must be in the current directory.
  158.  
  159. You are asked for a default frequency, speed ,weighting, ratio and timing.
  160. Timing ranges from 0 to 32767.    If set to 0
  161. it is automatically initialized using interrupt 1ch whenever you run morse.
  162.  This ensures that morse will run approximately at the same speed on all
  163.  machines.  If you are not satisfied with this value, a nonzero timing may be
  164.  entered.
  165.  
  166. Next you are asked if you want practice  mode on.  If you say yes, practice mode
  167. will be on by default.    Next you can indicate whether clicks should be on or
  168. off.  If on, a click is sounded every time a carriage return is encountered and
  169. the ALT key is pressed.
  170.  
  171. The last option allows you to modify the morse translation table.  Use
  172. this option if you want to change the morse equivalent of a character. To
  173. change a character, enter the character you want to changed. You are prompted
  174. for the morse representation of the character using a period for dit and
  175. a dash for a dot.  For example the letter q would be represented as --.-
  176.  
  177. I have been told that some of my morse characters for punctuation are
  178. incorrect. They were copied from my Zitex Ascii to Morse converter I used
  179. to use to get output from my first computer in 1978. So feel free to make
  180. the punctuation whatever you want.
  181. Remember to make a backup copy of morse.com before configuration.
  182.  
  183. Notes:
  184. Morse.com was written in MASM 5.1.  It is a rewrite of a program I wrote
  185. in Turbo Pascal a few years ago.  Morse.com only uses 6K of memory when
  186. resident.  Remember that morse.com contains reconfiguration  code and
  187. a help message which are not kept after it becomes resident.
  188.  
  189. It is possible to make several copies of morse run at the same time.
  190. Each morse.com can be set to its own speed and frequency.  This may not
  191. be very useful, but it illistrates how output can go from one copy of
  192. morse to another and eventually to the screen.    You should reboot your
  193. system to remove multiple copies of morse.com.
  194.  
  195. Morse.com was written primarily for the blind or deaf-blind
  196. computer user.    It allows me to use a PC without a voice synthesizer.
  197.  
  198. I have decided to include the assembly source for morse.com. The only
  199. restriction is that you cannot use this source to derive a program sold for
  200. profit.
  201.  
  202. I welcome any constructive criticism.  I realize that some of the source
  203. is very good, some is bad and the rest might be ok.  I am gradually going
  204. through the code putting in more comments and looking for bugs.
  205.  
  206. Send bug reports or any improved source code to:
  207. rcf@genrad.com.
  208.  
  209.